BASS_SAMPLE structure

Used with BASS_SampleGetInfo and BASS_SampleSetInfo to retrieve and set the default playback attributes of a sample.

typedef struct { DWORD freq; DWORD volume; int pan; DWORD flags; DWORD length; DWORD max; DWORD mode3d; float mindist; float maxdist; DWORD iangle; DWORD oangle; DWORD outvol; } BASS_SAMPLE;

Members

freq Default playback rate.

volume Default volume... 0 (silent) - 100 (max).

pan Default panning position... -100 (left) - 100 (right).

flags A combination of these flags.

BASS_SAMPLE_8BITS 8 bit resolution, else 16 bit.
BASS_SAMPLE_MONO Mono, else stereo.
BASS_SAMPLE_LOOP Looped?
BASS_SAMPLE_3D The sample has 3D functionality enabled.
BASS_SAMPLE_SOFTWARE The sample is not using hardware mixing... it is being mixed in software by DirectSound.
BASS_SAMPLE_OVER_VOL Override: the channel with the lowest volume is overriden.
BASS_SAMPLE_OVER_POS Override: the longest playing channel is overriden.

length The length in samples (not bytes).

max Maximum number of simultaneous playbacks.

The following are the sample's default 3D attributes (if the sample is 3D).

mode3d The 3D processing mode... one of these flags.

BASS_3DMODE_NORMAL Normal 3D processing.
BASS_3DMODE_RELATIVE The sample's 3D position (position/velocity/orientation) is relative to the listener. When the listener's position/velocity/orientation is changed with BASS_Set3DPosition, the sample's position relative to the listener does not change.
BASS_3DMODE_OFF Turn off 3D processing on the sample, the sound will be played in the center.

mindist The minimum distance. The sample's volume stops increasing when the listener is within this distance.

maxdist The maximum distance. The sample's volume stops decreasing when the listener is past this distance.

iangle The angle of the inside projection cone in degrees... 0 (no cone) - 360 (sphere).

oangle The angle of the outside projection cone in degrees... 0 (no cone) - 360 (sphere).

outvol The delta-volume outside the outer projection cone... 0 (silent) - 100 (same as inside the cone).

Remarks
When a sample has 3D functionality, the iangle and oangle angles decide how wide the sound is projected around the orientation angle (as specified when calling BASS_SamplePlay3D, or as set with BASS_ChannelSet3DPosition when the sample is playing). Within the inside angle the volume level is the level set in the volume member (or as set with BASS_ChannelSetAttributes when the sample is playing). Outside the outer angle, the volume changes according to the outvol value. Between the inner and outer angles, the volume gradually changes between the inner and outer volume levels. If the inner and outer angles are 360 degrees, then the sound is transmitted equally in all directions.